Developer Documentation

QuickTime 4 API Documentation
QuickTime Music Architecture

| Previous | Chapter Contents | Chapter Top | Next |

Instrument Match Flags

These flags are returned in the instMatch field of the General MIDI instrument information structure [link] to specify how QuickTime music architecture matched an instrument request to an instrument.

enum {
    kInstrumentExactMatch               = 0x00020000,
    kInstrumentRecommendedSubstitute    = 0x00010000,
    kInstrumentQualityField             = 0xFF000000,
    kRoland8BitQuality          = 0x05000000
};
typedef InstrumentAboutInfo *InstrumentAboutInfoPtr;
typedef InstrumentAboutInfoPtr *InstrumentAboutInfoHandle;

Constant descriptions

kInstrumentExactMatch
The instrument exactly matches the request.

kInstrumentRecommendedSubstitute
The instrument is the approved substitute.

kInstrumentQualityField
The high-order 8 bits of this field specify the quality of the selected instrument. Higher values specify higher quality.

kRoland8BitQuality
For built-in instruments, the value of the high-order 8 bits is always kInstrumentRoland8BitQuality, which corresponds to the quality of an 8-bit Roland instrument.

© 1999 Apple Computer, Inc.

| Previous | Chapter Contents | Chapter Top | Next |